home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / hotjava / classsrc / java / io / output~1.jav < prev    next >
Encoding:
Text File  |  1995-08-11  |  2.4 KB  |  84 lines
  1. /*
  2.  * @(#)OutputStream.java    1.7 95/01/31 Arthur van Hoff
  3.  *
  4.  * Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
  5.  *
  6.  * Permission to use, copy, modify, and distribute this software
  7.  * and its documentation for NON-COMMERCIAL purposes and without
  8.  * fee is hereby granted provided that this copyright notice
  9.  * appears in all copies. Please refer to the file "copyright.html"
  10.  * for further important copyright and licensing information.
  11.  *
  12.  * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
  13.  * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  14.  * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  15.  * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
  16.  * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
  17.  * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
  18.  */
  19.  
  20. package java.io;
  21.  
  22. /**
  23.  * Abstract class representing an output stream of bytes.
  24.  * All OutputStreams are based on this class.
  25.  * @see        InputStream
  26.  * @see        FilterOutputStream
  27.  * @see        BufferedOutputStream
  28.  * @see        DataOutputStream
  29.  * @see        OutputStreamBuffer
  30.  * @version     1.7, 31 Jan 1995
  31.  * @author    Arthur van Hoff
  32.  */
  33. public
  34. class OutputStream {
  35.     /**
  36.      * Writes a byte. Will block until the byte is actually
  37.      * written.
  38.      * @param b    the byte
  39.      * @exception IOException i/o error occurred
  40.      */
  41.     public abstract void write(int b);
  42.  
  43.     /**
  44.      * Writes an array of bytes. Will block until the bytes
  45.      * are actually written.
  46.      * @param b    the data to be written
  47.      * @exception IOException i/o error occurred
  48.      */
  49.     public void write(byte b[]) {
  50.     write(b, 0, b.length);
  51.     }
  52.  
  53.     /**
  54.      * Writes a sub array of bytes. To be efficient it should
  55.      * be overridden in a subclass. 
  56.      * @param b    the data to be written
  57.      * @param off    the start offset in the data
  58.      * @param len    the number of bytes that are written
  59.      * @exception IOException i/o error occurred
  60.      */
  61.     public void write(byte b[], int off, int len) {
  62.     for (int i = 0 ; i < len ; i++) {
  63.         write(b[off + i]);
  64.     }
  65.     }
  66.  
  67.     /**
  68.      * Flushes the stream. This will write any buffered
  69.      * output bytes.
  70.      * @exception IOException i/o error occurred
  71.      */
  72.     public void flush() {
  73.     }
  74.  
  75.     /**
  76.      * Closes the stream. This method must be called
  77.      * to release any resources associated with the
  78.      * stream.
  79.      * @exception IOException i/o error occurred
  80.      */
  81.     public void close() {
  82.     }
  83. }
  84.